home *** CD-ROM | disk | FTP | other *** search
/ Windows News 2005 November / WNnov2005.iso / Windows / Equipement / hMailServer / hMailServer-4.1-Build-136.exe / {app} / PHPWebAdmin / include / smarty / Smarty.class.php < prev   
PHP Script  |  2004-10-24  |  65KB  |  1,933 lines
  1. <?php
  2.  
  3. /**
  4.  * Project:     Smarty: the PHP compiling template engine
  5.  * File:        Smarty.class.php
  6.  *
  7.  * This library is free software; you can redistribute it and/or
  8.  * modify it under the terms of the GNU Lesser General Public
  9.  * License as published by the Free Software Foundation; either
  10.  * version 2.1 of the License, or (at your option) any later version.
  11.  *
  12.  * This library is distributed in the hope that it will be useful,
  13.  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  14.  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  15.  * Lesser General Public License for more details.
  16.  *
  17.  * You should have received a copy of the GNU Lesser General Public
  18.  * License along with this library; if not, write to the Free Software
  19.  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  20.  *
  21.  * For questions, help, comments, discussion, etc., please join the
  22.  * Smarty mailing list. Send a blank e-mail to
  23.  * smarty-general-subscribe@lists.php.net
  24.  *
  25.  * @link http://smarty.php.net/
  26.  * @copyright 2001-2004 ispi of Lincoln, Inc.
  27.  * @author Monte Ohrt <monte@ispi.net>
  28.  * @author Andrei Zmievski <andrei@php.net>
  29.  * @package Smarty
  30.  * @version 2.6.5-dev
  31.  */
  32.  
  33. /* $Id: Smarty.class.php,v 1.1 2004/10/24 20:24:25 rabol Exp $ */
  34.  
  35. /**
  36.  * DIR_SEP isn't used anymore, but third party apps might
  37.  */
  38. if(!defined('DIR_SEP')) {
  39.     define('DIR_SEP', DIRECTORY_SEPARATOR);
  40. }
  41.  
  42. /**
  43.  * set SMARTY_DIR to absolute path to Smarty library files.
  44.  * if not defined, include_path will be used. Sets SMARTY_DIR only if user
  45.  * application has not already defined it.
  46.  */
  47.  
  48. if (!defined('SMARTY_DIR')) {
  49.     define('SMARTY_DIR', dirname(__FILE__) . DIRECTORY_SEPARATOR);
  50. }
  51.  
  52. define('SMARTY_PHP_PASSTHRU',   0);
  53. define('SMARTY_PHP_QUOTE',      1);
  54. define('SMARTY_PHP_REMOVE',     2);
  55. define('SMARTY_PHP_ALLOW',      3);
  56.  
  57. /**
  58.  * @package Smarty
  59.  */
  60. class Smarty
  61. {
  62.     /**#@+
  63.      * Smarty Configuration Section
  64.      */
  65.  
  66.     /**
  67.      * The name of the directory where templates are located.
  68.      *
  69.      * @var string
  70.      */
  71.     var $template_dir    =  'templates';
  72.  
  73.     /**
  74.      * The directory where compiled templates are located.
  75.      *
  76.      * @var string
  77.      */
  78.     var $compile_dir     =  'templates_c';
  79.  
  80.     /**
  81.      * The directory where config files are located.
  82.      *
  83.      * @var string
  84.      */
  85.     var $config_dir      =  'configs';
  86.  
  87.     /**
  88.      * An array of directories searched for plugins.
  89.      *
  90.      * @var array
  91.      */
  92.     var $plugins_dir     =  array('plugins');
  93.  
  94.     /**
  95.      * If debugging is enabled, a debug console window will display
  96.      * when the page loads (make sure your browser allows unrequested
  97.      * popup windows)
  98.      *
  99.      * @var boolean
  100.      */
  101.     var $debugging       =  false;
  102.  
  103.     /**
  104.      * When set, smarty does uses this value as error_reporting-level.
  105.      *
  106.      * @var boolean
  107.      */
  108.     var $error_reporting  =  null;
  109.  
  110.     /**
  111.      * This is the path to the debug console template. If not set,
  112.      * the default one will be used.
  113.      *
  114.      * @var string
  115.      */
  116.     var $debug_tpl       =  '';
  117.  
  118.     /**
  119.      * This determines if debugging is enable-able from the browser.
  120.      * <ul>
  121.      *  <li>NONE => no debugging control allowed</li>
  122.      *  <li>URL => enable debugging when SMARTY_DEBUG is found in the URL.</li>
  123.      * </ul>
  124.      * @link http://www.foo.dom/index.php?SMARTY_DEBUG
  125.      * @var string
  126.      */
  127.     var $debugging_ctrl  =  'NONE';
  128.  
  129.     /**
  130.      * This tells Smarty whether to check for recompiling or not. Recompiling
  131.      * does not need to happen unless a template or config file is changed.
  132.      * Typically you enable this during development, and disable for
  133.      * production.
  134.      *
  135.      * @var boolean
  136.      */
  137.     var $compile_check   =  true;
  138.  
  139.     /**
  140.      * This forces templates to compile every time. Useful for development
  141.      * or debugging.
  142.      *
  143.      * @var boolean
  144.      */
  145.     var $force_compile   =  false;
  146.  
  147.     /**
  148.      * This enables template caching.
  149.      * <ul>
  150.      *  <li>0 = no caching</li>
  151.      *  <li>1 = use class cache_lifetime value</li>
  152.      *  <li>2 = use cache_lifetime in cache file</li>
  153.      * </ul>
  154.      * @var integer
  155.      */
  156.     var $caching         =  0;
  157.  
  158.     /**
  159.      * The name of the directory for cache files.
  160.      *
  161.      * @var string
  162.      */
  163.     var $cache_dir       =  'cache';
  164.  
  165.     /**
  166.      * This is the number of seconds cached content will persist.
  167.      * <ul>
  168.      *  <li>0 = always regenerate cache</li>
  169.      *  <li>-1 = never expires</li>
  170.      * </ul>
  171.      *
  172.      * @var integer
  173.      */
  174.     var $cache_lifetime  =  3600;
  175.  
  176.     /**
  177.      * Only used when $caching is enabled. If true, then If-Modified-Since headers
  178.      * are respected with cached content, and appropriate HTTP headers are sent.
  179.      * This way repeated hits to a cached page do not send the entire page to the
  180.      * client every time.
  181.      *
  182.      * @var boolean
  183.      */
  184.     var $cache_modified_check = false;
  185.  
  186.     /**
  187.      * This determines how Smarty handles "<?php ... ?>" tags in templates.
  188.      * possible values:
  189.      * <ul>
  190.      *  <li>SMARTY_PHP_PASSTHRU -> print tags as plain text</li>
  191.      *  <li>SMARTY_PHP_QUOTE    -> escape tags as entities</li>
  192.      *  <li>SMARTY_PHP_REMOVE   -> remove php tags</li>
  193.      *  <li>SMARTY_PHP_ALLOW    -> execute php tags</li>
  194.      * </ul>
  195.      *
  196.      * @var integer
  197.      */
  198.     var $php_handling    =  SMARTY_PHP_PASSTHRU;
  199.  
  200.     /**
  201.      * This enables template security. When enabled, many things are restricted
  202.      * in the templates that normally would go unchecked. This is useful when
  203.      * untrusted parties are editing templates and you want a reasonable level
  204.      * of security. (no direct execution of PHP in templates for example)
  205.      *
  206.      * @var boolean
  207.      */
  208.     var $security       =   false;
  209.  
  210.     /**
  211.      * This is the list of template directories that are considered secure. This
  212.      * is used only if {@link $security} is enabled. One directory per array
  213.      * element.  {@link $template_dir} is in this list implicitly.
  214.      *
  215.      * @var array
  216.      */
  217.     var $secure_dir     =   array();
  218.  
  219.     /**
  220.      * These are the security settings for Smarty. They are used only when
  221.      * {@link $security} is enabled.
  222.      *
  223.      * @var array
  224.      */
  225.     var $security_settings  = array(
  226.                                     'PHP_HANDLING'    => false,
  227.                                     'IF_FUNCS'        => array('array', 'list',
  228.                                                                'isset', 'empty',
  229.                                                                'count', 'sizeof',
  230.                                                                'in_array', 'is_array',
  231.                                                                'true','false'),
  232.                                     'INCLUDE_ANY'     => false,
  233.                                     'PHP_TAGS'        => false,
  234.                                     'MODIFIER_FUNCS'  => array('count'),
  235.                                     'ALLOW_CONSTANTS'  => false
  236.                                    );
  237.  
  238.     /**
  239.      * This is an array of directories where trusted php scripts reside.
  240.      * {@link $security} is disabled during their inclusion/execution.
  241.      *
  242.      * @var array
  243.      */
  244.     var $trusted_dir        = array();
  245.  
  246.     /**
  247.      * The left delimiter used for the template tags.
  248.      *
  249.      * @var string
  250.      */
  251.     var $left_delimiter  =  '{';
  252.  
  253.     /**
  254.      * The right delimiter used for the template tags.
  255.      *
  256.      * @var string
  257.      */
  258.     var $right_delimiter =  '}';
  259.  
  260.     /**
  261.      * The order in which request variables are registered, similar to
  262.      * variables_order in php.ini E = Environment, G = GET, P = POST,
  263.      * C = Cookies, S = Server
  264.      *
  265.      * @var string
  266.      */
  267.     var $request_vars_order    = 'EGPCS';
  268.  
  269.     /**
  270.      * Indicates wether $HTTP_*_VARS[] (request_use_auto_globals=false)
  271.      * are uses as request-vars or $_*[]-vars. note: if
  272.      * request_use_auto_globals is true, then $request_vars_order has
  273.      * no effect, but the php-ini-value "gpc_order"
  274.      *
  275.      * @var boolean
  276.      */
  277.     var $request_use_auto_globals      = true;
  278.  
  279.     /**
  280.      * Set this if you want different sets of compiled files for the same
  281.      * templates. This is useful for things like different languages.
  282.      * Instead of creating separate sets of templates per language, you
  283.      * set different compile_ids like 'en' and 'de'.
  284.      *
  285.      * @var string
  286.      */
  287.     var $compile_id            = null;
  288.  
  289.     /**
  290.      * This tells Smarty whether or not to use sub dirs in the cache/ and
  291.      * templates_c/ directories. sub directories better organized, but
  292.      * may not work well with PHP safe mode enabled.
  293.      *
  294.      * @var boolean
  295.      *
  296.      */
  297.     var $use_sub_dirs          = false;
  298.  
  299.     /**
  300.      * This is a list of the modifiers to apply to all template variables.
  301.      * Put each modifier in a separate array element in the order you want
  302.      * them applied. example: <code>array('escape:"htmlall"');</code>
  303.      *
  304.      * @var array
  305.      */
  306.     var $default_modifiers        = array();
  307.  
  308.     /**
  309.      * This is the resource type to be used when not specified
  310.      * at the beginning of the resource path. examples:
  311.      * $smarty->display('file:index.tpl');
  312.      * $smarty->display('db:index.tpl');
  313.      * $smarty->display('index.tpl'); // will use default resource type
  314.      * {include file="file:index.tpl"}
  315.      * {include file="db:index.tpl"}
  316.      * {include file="index.tpl"} {* will use default resource type *}
  317.      *
  318.      * @var array
  319.      */
  320.     var $default_resource_type    = 'file';
  321.  
  322.     /**
  323.      * The function used for cache file handling. If not set, built-in caching is used.
  324.      *
  325.      * @var null|string function name
  326.      */
  327.     var $cache_handler_func   = null;
  328.  
  329.     /**
  330.      * This indicates which filters are automatically loaded into Smarty.
  331.      *
  332.      * @var array array of filter names
  333.      */
  334.     var $autoload_filters = array();
  335.  
  336.     /**#@+
  337.      * @var boolean
  338.      */
  339.     /**
  340.      * This tells if config file vars of the same name overwrite each other or not.
  341.      * if disabled, same name variables are accumulated in an array.
  342.      */
  343.     var $config_overwrite = true;
  344.  
  345.     /**
  346.      * This tells whether or not to automatically booleanize config file variables.
  347.      * If enabled, then the strings "on", "true", and "yes" are treated as boolean
  348.      * true, and "off", "false" and "no" are treated as boolean false.
  349.      */
  350.     var $config_booleanize = true;
  351.  
  352.     /**
  353.      * This tells whether hidden sections [.foobar] are readable from the
  354.      * tempalates or not. Normally you would never allow this since that is
  355.      * the point behind hidden sections: the application can access them, but
  356.      * the templates cannot.
  357.      */
  358.     var $config_read_hidden = false;
  359.  
  360.     /**
  361.      * This tells whether or not automatically fix newlines in config files.
  362.      * It basically converts \r (mac) or \r\n (dos) to \n
  363.      */
  364.     var $config_fix_newlines = true;
  365.     /**#@-*/
  366.  
  367.     /**
  368.      * If a template cannot be found, this PHP function will be executed.
  369.      * Useful for creating templates on-the-fly or other special action.
  370.      *
  371.      * @var string function name
  372.      */
  373.     var $default_template_handler_func = '';
  374.  
  375.     /**
  376.      * The file that contains the compiler class. This can a full
  377.      * pathname, or relative to the php_include path.
  378.      *
  379.      * @var string
  380.      */
  381.     var $compiler_file        =    'Smarty_Compiler.class.php';
  382.  
  383.     /**
  384.      * The class used for compiling templates.
  385.      *
  386.      * @var string
  387.      */
  388.     var $compiler_class        =   'Smarty_Compiler';
  389.  
  390.     /**
  391.      * The class used to load config vars.
  392.      *
  393.      * @var string
  394.      */
  395.     var $config_class          =   'Config_File';
  396.  
  397. /**#@+
  398.  * END Smarty Configuration Section
  399.  * There should be no need to touch anything below this line.
  400.  * @access private
  401.  */
  402.     /**
  403.      * where assigned template vars are kept
  404.      *
  405.      * @var array
  406.      */
  407.     var $_tpl_vars             = array();
  408.  
  409.     /**
  410.      * stores run-time $smarty.* vars
  411.      *
  412.      * @var null|array
  413.      */
  414.     var $_smarty_vars          = null;
  415.  
  416.     /**
  417.      * keeps track of sections
  418.      *
  419.      * @var array
  420.      */
  421.     var $_sections             = array();
  422.  
  423.     /**
  424.      * keeps track of foreach blocks
  425.      *
  426.      * @var array
  427.      */
  428.     var $_foreach              = array();
  429.  
  430.     /**
  431.      * keeps track of tag hierarchy
  432.      *
  433.      * @var array
  434.      */
  435.     var $_tag_stack            = array();
  436.  
  437.     /**
  438.      * configuration object
  439.      *
  440.      * @var Config_file
  441.      */
  442.     var $_conf_obj             = null;
  443.  
  444.     /**
  445.      * loaded configuration settings
  446.      *
  447.      * @var array
  448.      */
  449.     var $_config               = array(array('vars'  => array(), 'files' => array()));
  450.  
  451.     /**
  452.      * md5 checksum of the string 'Smarty'
  453.      *
  454.      * @var string
  455.      */
  456.     var $_smarty_md5           = 'f8d698aea36fcbead2b9d5359ffca76f';
  457.  
  458.     /**
  459.      * Smarty version number
  460.      *
  461.      * @var string
  462.      */
  463.     var $_version              = '2.6.5-dev';
  464.  
  465.     /**
  466.      * current template inclusion depth
  467.      *
  468.      * @var integer
  469.      */
  470.     var $_inclusion_depth      = 0;
  471.  
  472.     /**
  473.      * for different compiled templates
  474.      *
  475.      * @var string
  476.      */
  477.     var $_compile_id           = null;
  478.  
  479.     /**
  480.      * text in URL to enable debug mode
  481.      *
  482.      * @var string
  483.      */
  484.     var $_smarty_debug_id      = 'SMARTY_DEBUG';
  485.  
  486.     /**
  487.      * debugging information for debug console
  488.      *
  489.      * @var array
  490.      */
  491.     var $_smarty_debug_info    = array();
  492.  
  493.     /**
  494.      * info that makes up a cache file
  495.      *
  496.      * @var array
  497.      */
  498.     var $_cache_info           = array();
  499.  
  500.     /**
  501.      * default file permissions
  502.      *
  503.      * @var integer
  504.      */
  505.     var $_file_perms           = 0644;
  506.  
  507.     /**
  508.      * default dir permissions
  509.      *
  510.      * @var integer
  511.      */
  512.     var $_dir_perms               = 0771;
  513.  
  514.     /**
  515.      * registered objects
  516.      *
  517.      * @var array
  518.      */
  519.     var $_reg_objects           = array();
  520.  
  521.     /**
  522.      * table keeping track of plugins
  523.      *
  524.      * @var array
  525.      */
  526.     var $_plugins              = array(
  527.                                        'modifier'      => array(),
  528.                                        'function'      => array(),
  529.                                        'block'         => array(),
  530.                                        'compiler'      => array(),
  531.                                        'prefilter'     => array(),
  532.                                        'postfilter'    => array(),
  533.                                        'outputfilter'  => array(),
  534.                                        'resource'      => array(),
  535.                                        'insert'        => array());
  536.  
  537.  
  538.     /**
  539.      * cache serials
  540.      *
  541.      * @var array
  542.      */
  543.     var $_cache_serials = array();
  544.  
  545.     /**
  546.      * name of optional cache include file
  547.      *
  548.      * @var string
  549.      */
  550.     var $_cache_include = null;
  551.  
  552.     /**
  553.      * indicate if the current code is used in a compiled
  554.      * include
  555.      *
  556.      * @var string
  557.      */
  558.     var $_cache_including = false;
  559.  
  560.     /**#@-*/
  561.     /**
  562.      * The class constructor.
  563.      */
  564.     function Smarty()
  565.     {
  566.       $this->assign('SCRIPT_NAME', isset($_SERVER['SCRIPT_NAME']) ? $_SERVER['SCRIPT_NAME']
  567.                     : @$GLOBALS['HTTP_SERVER_VARS']['SCRIPT_NAME']);
  568.     }
  569.  
  570.     /**
  571.      * assigns values to template variables
  572.      *
  573.      * @param array|string $tpl_var the template variable name(s)
  574.      * @param mixed $value the value to assign
  575.      */
  576.     function assign($tpl_var, $value = null)
  577.     {
  578.         if (is_array($tpl_var)){
  579.             foreach ($tpl_var as $key => $val) {
  580.                 if ($key != '') {
  581.                     $this->_tpl_vars[$key] = $val;
  582.                 }
  583.             }
  584.         } else {
  585.             if ($tpl_var != '')
  586.                 $this->_tpl_vars[$tpl_var] = $value;
  587.         }
  588.     }
  589.  
  590.     /**
  591.      * assigns values to template variables by reference
  592.      *
  593.      * @param string $tpl_var the template variable name
  594.      * @param mixed $value the referenced value to assign
  595.      */
  596.     function assign_by_ref($tpl_var, &$value)
  597.     {
  598.         if ($tpl_var != '')
  599.             $this->_tpl_vars[$tpl_var] = &$value;
  600.     }
  601.  
  602.     /**
  603.      * appends values to template variables
  604.      *
  605.      * @param array|string $tpl_var the template variable name(s)
  606.      * @param mixed $value the value to append
  607.      */
  608.     function append($tpl_var, $value=null, $merge=false)
  609.     {
  610.         if (is_array($tpl_var)) {
  611.             // $tpl_var is an array, ignore $value
  612.             foreach ($tpl_var as $_key => $_val) {
  613.                 if ($_key != '') {
  614.                     if(!@is_array($this->_tpl_vars[$_key])) {
  615.                         settype($this->_tpl_vars[$_key],'array');
  616.                     }
  617.                     if($merge && is_array($_val)) {
  618.                         foreach($_val as $_mkey => $_mval) {
  619.                             $this->_tpl_vars[$_key][$_mkey] = $_mval;
  620.                         }
  621.                     } else {
  622.                         $this->_tpl_vars[$_key][] = $_val;
  623.                     }
  624.                 }
  625.             }
  626.         } else {
  627.             if ($tpl_var != '' && isset($value)) {
  628.                 if(!@is_array($this->_tpl_vars[$tpl_var])) {
  629.                     settype($this->_tpl_vars[$tpl_var],'array');
  630.                 }
  631.                 if($merge && is_array($value)) {
  632.                     foreach($value as $_mkey => $_mval) {
  633.                         $this->_tpl_vars[$tpl_var][$_mkey] = $_mval;
  634.                     }
  635.                 } else {
  636.                     $this->_tpl_vars[$tpl_var][] = $value;
  637.                 }
  638.             }
  639.         }
  640.     }
  641.  
  642.     /**
  643.      * appends values to template variables by reference
  644.      *
  645.      * @param string $tpl_var the template variable name
  646.      * @param mixed $value the referenced value to append
  647.      */
  648.     function append_by_ref($tpl_var, &$value, $merge=false)
  649.     {
  650.         if ($tpl_var != '' && isset($value)) {
  651.             if(!@is_array($this->_tpl_vars[$tpl_var])) {
  652.              settype($this->_tpl_vars[$tpl_var],'array');
  653.             }
  654.             if ($merge && is_array($value)) {
  655.                 foreach($value as $_key => $_val) {
  656.                     $this->_tpl_vars[$tpl_var][$_key] = &$value[$_key];
  657.                 }
  658.             } else {
  659.                 $this->_tpl_vars[$tpl_var][] = &$value;
  660.             }
  661.         }
  662.     }
  663.  
  664.  
  665.     /**
  666.      * clear the given assigned template variable.
  667.      *
  668.      * @param string $tpl_var the template variable to clear
  669.      */
  670.     function clear_assign($tpl_var)
  671.     {
  672.         if (is_array($tpl_var))
  673.             foreach ($tpl_var as $curr_var)
  674.                 unset($this->_tpl_vars[$curr_var]);
  675.         else
  676.             unset($this->_tpl_vars[$tpl_var]);
  677.     }
  678.  
  679.  
  680.     /**
  681.      * Registers custom function to be used in templates
  682.      *
  683.      * @param string $function the name of the template function
  684.      * @param string $function_impl the name of the PHP function to register
  685.      */
  686.     function register_function($function, $function_impl, $cacheable=true, $cache_attrs=null)
  687.     {
  688.         $this->_plugins['function'][$function] =
  689.             array($function_impl, null, null, false, $cacheable, $cache_attrs);
  690.  
  691.     }
  692.  
  693.     /**
  694.      * Unregisters custom function
  695.      *
  696.      * @param string $function name of template function
  697.      */
  698.     function unregister_function($function)
  699.     {
  700.         unset($this->_plugins['function'][$function]);
  701.     }
  702.  
  703.     /**
  704.      * Registers object to be used in templates
  705.      *
  706.      * @param string $object name of template object
  707.      * @param object &$object_impl the referenced PHP object to register
  708.      * @param null|array $allowed list of allowed methods (empty = all)
  709.      * @param boolean $smarty_args smarty argument format, else traditional
  710.      * @param null|array $block_functs list of methods that are block format
  711.      */
  712.     function register_object($object, &$object_impl, $allowed = array(), $smarty_args = true, $block_methods = array())
  713.     {
  714.         settype($allowed, 'array');
  715.         settype($smarty_args, 'boolean');
  716.         $this->_reg_objects[$object] =
  717.             array(&$object_impl, $allowed, $smarty_args, $block_methods);
  718.     }
  719.  
  720.     /**
  721.      * Unregisters object
  722.      *
  723.      * @param string $object name of template object
  724.      */
  725.     function unregister_object($object)
  726.     {
  727.         unset($this->_reg_objects[$object]);
  728.     }
  729.  
  730.  
  731.     /**
  732.      * Registers block function to be used in templates
  733.      *
  734.      * @param string $block name of template block
  735.      * @param string $block_impl PHP function to register
  736.      */
  737.     function register_block($block, $block_impl, $cacheable=true, $cache_attrs=null)
  738.     {
  739.         $this->_plugins['block'][$block] =
  740.             array($block_impl, null, null, false, $cacheable, $cache_attrs);
  741.     }
  742.  
  743.     /**
  744.      * Unregisters block function
  745.      *
  746.      * @param string $block name of template function
  747.      */
  748.     function unregister_block($block)
  749.     {
  750.         unset($this->_plugins['block'][$block]);
  751.     }
  752.  
  753.     /**
  754.      * Registers compiler function
  755.      *
  756.      * @param string $function name of template function
  757.      * @param string $function_impl name of PHP function to register
  758.      */
  759.     function register_compiler_function($function, $function_impl, $cacheable=true)
  760.     {
  761.         $this->_plugins['compiler'][$function] =
  762.             array($function_impl, null, null, false, $cacheable);
  763.     }
  764.  
  765.     /**
  766.      * Unregisters compiler function
  767.      *
  768.      * @param string $function name of template function
  769.      */
  770.     function unregister_compiler_function($function)
  771.     {
  772.         unset($this->_plugins['compiler'][$function]);
  773.     }
  774.  
  775.     /**
  776.      * Registers modifier to be used in templates
  777.      *
  778.      * @param string $modifier name of template modifier
  779.      * @param string $modifier_impl name of PHP function to register
  780.      */
  781.     function register_modifier($modifier, $modifier_impl)
  782.     {
  783.         $this->_plugins['modifier'][$modifier] =
  784.             array($modifier_impl, null, null, false);
  785.     }
  786.  
  787.     /**
  788.      * Unregisters modifier
  789.      *
  790.      * @param string $modifier name of template modifier
  791.      */
  792.     function unregister_modifier($modifier)
  793.     {
  794.         unset($this->_plugins['modifier'][$modifier]);
  795.     }
  796.  
  797.     /**
  798.      * Registers a resource to fetch a template
  799.      *
  800.      * @param string $type name of resource
  801.      * @param array $functions array of functions to handle resource
  802.      */
  803.     function register_resource($type, $functions)
  804.     {
  805.         if (count($functions)==4) {
  806.             $this->_plugins['resource'][$type] =
  807.                 array($functions, false);
  808.  
  809.         } elseif (count($functions)==5) {
  810.             $this->_plugins['resource'][$type] =
  811.                 array(array(array(&$functions[0], $functions[1])
  812.                             ,array(&$functions[0], $functions[2])
  813.                             ,array(&$functions[0], $functions[3])
  814.                             ,array(&$functions[0], $functions[4]))
  815.                       ,false);
  816.  
  817.         } else {
  818.             $this->trigger_error("malformed function-list for '$type' in register_resource");
  819.  
  820.         }
  821.     }
  822.  
  823.     /**
  824.      * Unregisters a resource
  825.      *
  826.      * @param string $type name of resource
  827.      */
  828.     function unregister_resource($type)
  829.     {
  830.         unset($this->_plugins['resource'][$type]);
  831.     }
  832.  
  833.     /**
  834.      * Registers a prefilter function to apply
  835.      * to a template before compiling
  836.      *
  837.      * @param string $function name of PHP function to register
  838.      */
  839.     function register_prefilter($function)
  840.     {
  841.     $_name = (is_array($function)) ? $function[1] : $function;
  842.         $this->_plugins['prefilter'][$_name]
  843.             = array($function, null, null, false);
  844.     }
  845.  
  846.     /**
  847.      * Unregisters a prefilter function
  848.      *
  849.      * @param string $function name of PHP function
  850.      */
  851.     function unregister_prefilter($function)
  852.     {
  853.         unset($this->_plugins['prefilter'][$function]);
  854.     }
  855.  
  856.     /**
  857.      * Registers a postfilter function to apply
  858.      * to a compiled template after compilation
  859.      *
  860.      * @param string $function name of PHP function to register
  861.      */
  862.     function register_postfilter($function)
  863.     {
  864.     $_name = (is_array($function)) ? $function[1] : $function;
  865.         $this->_plugins['postfilter'][$_name]
  866.             = array($function, null, null, false);
  867.     }
  868.  
  869.     /**
  870.      * Unregisters a postfilter function
  871.      *
  872.      * @param string $function name of PHP function
  873.      */
  874.     function unregister_postfilter($function)
  875.     {
  876.         unset($this->_plugins['postfilter'][$function]);
  877.     }
  878.  
  879.     /**
  880.      * Registers an output filter function to apply
  881.      * to a template output
  882.      *
  883.      * @param string $function name of PHP function
  884.      */
  885.     function register_outputfilter($function)
  886.     {
  887.     $_name = (is_array($function)) ? $function[1] : $function;
  888.         $this->_plugins['outputfilter'][$_name]
  889.             = array($function, null, null, false);
  890.     }
  891.  
  892.     /**
  893.      * Unregisters an outputfilter function
  894.      *
  895.      * @param string $function name of PHP function
  896.      */
  897.     function unregister_outputfilter($function)
  898.     {
  899.         unset($this->_plugins['outputfilter'][$function]);
  900.     }
  901.  
  902.     /**
  903.      * load a filter of specified type and name
  904.      *
  905.      * @param string $type filter type
  906.      * @param string $name filter name
  907.      */
  908.     function load_filter($type, $name)
  909.     {
  910.         switch ($type) {
  911.             case 'output':
  912.                 $_params = array('plugins' => array(array($type . 'filter', $name, null, null, false)));
  913.                 require_once(SMARTY_DIR . 'core' . DIRECTORY_SEPARATOR . 'core.load_plugins.php');
  914.                 smarty_core_load_plugins($_params, $this);
  915.                 break;
  916.  
  917.             case 'pre':
  918.             case 'post':
  919.                 if (!isset($this->_plugins[$type . 'filter'][$name]))
  920.                     $this->_plugins[$type . 'filter'][$name] = false;
  921.                 break;
  922.         }
  923.     }
  924.  
  925.     /**
  926.      * clear cached content for the given template and cache id
  927.      *
  928.      * @param string $tpl_file name of template file
  929.      * @param string $cache_id name of cache_id
  930.      * @param string $compile_id name of compile_id
  931.      * @param string $exp_time expiration time
  932.      * @return boolean
  933.      */
  934.     function clear_cache($tpl_file = null, $cache_id = null, $compile_id = null, $exp_time = null)
  935.     {
  936.  
  937.         if (!isset($compile_id))
  938.             $compile_id = $this->compile_id;
  939.  
  940.         if (!isset($tpl_file))
  941.             $compile_id = null;
  942.  
  943.         $_auto_id = $this->_get_auto_id($cache_id, $compile_id);
  944.  
  945.         if (!empty($this->cache_handler_func)) {
  946.             return call_user_func_array($this->cache_handler_func,
  947.                                   array('clear', &$this, &$dummy, $tpl_file, $cache_id, $compile_id, $exp_time));
  948.         } else {
  949.             $_params = array('auto_base' => $this->cache_dir,
  950.                             'auto_source' => $tpl_file,
  951.                             'auto_id' => $_auto_id,
  952.                             'exp_time' => $exp_time);
  953.             require_once(SMARTY_DIR . 'core' . DIRECTORY_SEPARATOR . 'core.rm_auto.php');
  954.             return smarty_core_rm_auto($_params, $this);
  955.         }
  956.  
  957.     }
  958.  
  959.  
  960.     /**
  961.      * clear the entire contents of cache (all templates)
  962.      *
  963.      * @param string $exp_time expire time
  964.      * @return boolean results of {@link smarty_core_rm_auto()}
  965.      */
  966.     function clear_all_cache($exp_time = null)
  967.     {
  968.         return $this->clear_cache(null, null, null, $exp_time);
  969.     }
  970.  
  971.  
  972.     /**
  973.      * test to see if valid cache exists for this template
  974.      *
  975.      * @param string $tpl_file name of template file
  976.      * @param string $cache_id
  977.      * @param string $compile_id
  978.      * @return string|false results of {@link _read_cache_file()}
  979.      */
  980.     function is_cached($tpl_file, $cache_id = null, $compile_id = null)
  981.     {
  982.         if (!$this->caching)
  983.             return false;
  984.  
  985.         if (!isset($compile_id))
  986.             $compile_id = $this->compile_id;
  987.  
  988.         $_params = array(
  989.             'tpl_file' => $tpl_file,
  990.             'cache_id' => $cache_id,
  991.             'compile_id' => $compile_id
  992.         );
  993.         require_once(SMARTY_DIR . 'core' . DIRECTORY_SEPARATOR . 'core.read_cache_file.php');
  994.         return smarty_core_read_cache_file($_params, $this);
  995.     }
  996.  
  997.  
  998.     /**
  999.      * clear all the assigned template variables.
  1000.      *
  1001.      */
  1002.     function clear_all_assign()
  1003.     {
  1004.         $this->_tpl_vars = array();
  1005.     }
  1006.  
  1007.     /**
  1008.      * clears compiled version of specified template resource,
  1009.      * or all compiled template files if one is not specified.
  1010.      * This function is for advanced use only, not normally needed.
  1011.      *
  1012.      * @param string $tpl_file
  1013.      * @param string $compile_id
  1014.      * @param string $exp_time
  1015.      * @return boolean results of {@link smarty_core_rm_auto()}
  1016.      */
  1017.     function clear_compiled_tpl($tpl_file = null, $compile_id = null, $exp_time = null)
  1018.     {
  1019.         if (!isset($compile_id)) {
  1020.             $compile_id = $this->compile_id;
  1021.         }
  1022.         $_params = array('auto_base' => $this->compile_dir,
  1023.                         'auto_source' => $tpl_file,
  1024.                         'auto_id' => $compile_id,
  1025.                         'exp_time' => $exp_time,
  1026.                         'extensions' => array('.inc', '.php'));
  1027.         require_once(SMARTY_DIR . 'core' . DIRECTORY_SEPARATOR . 'core.rm_auto.php');
  1028.         return smarty_core_rm_auto($_params, $this);
  1029.     }
  1030.  
  1031.     /**
  1032.      * Checks whether requested template exists.
  1033.      *
  1034.      * @param string $tpl_file
  1035.      * @return boolean
  1036.      */
  1037.     function template_exists($tpl_file)
  1038.     {
  1039.         $_params = array('resource_name' => $tpl_file, 'quiet'=>true, 'get_source'=>false);
  1040.         return $this->_fetch_resource_info($_params);
  1041.     }
  1042.  
  1043.     /**
  1044.      * Returns an array containing template variables
  1045.      *
  1046.      * @param string $name
  1047.      * @param string $type
  1048.      * @return array
  1049.      */
  1050.     function &get_template_vars($name=null)
  1051.     {
  1052.         if(!isset($name)) {
  1053.             return $this->_tpl_vars;
  1054.         }
  1055.         if(isset($this->_tpl_vars[$name])) {
  1056.             return $this->_tpl_vars[$name];
  1057.         }
  1058.     }
  1059.  
  1060.     /**
  1061.      * Returns an array containing config variables
  1062.      *
  1063.      * @param string $name
  1064.      * @param string $type
  1065.      * @return array
  1066.      */
  1067.     function &get_config_vars($name=null)
  1068.     {
  1069.         if(!isset($name) && is_array($this->_config[0])) {
  1070.             return $this->_config[0]['vars'];
  1071.         } else if(isset($this->_config[0]['vars'][$name])) {
  1072.             return $this->_config[0]['vars'][$name];
  1073.         }
  1074.     }
  1075.  
  1076.     /**
  1077.      * trigger Smarty error
  1078.      *
  1079.      * @param string $error_msg
  1080.      * @param integer $error_type
  1081.      */
  1082.     function trigger_error($error_msg, $error_type = E_USER_WARNING)
  1083.     {
  1084.         trigger_error("Smarty error: $error_msg", $error_type);
  1085.     }
  1086.  
  1087.  
  1088.     /**
  1089.      * executes & displays the template results
  1090.      *
  1091.      * @param string $resource_name
  1092.      * @param string $cache_id
  1093.      * @param string $compile_id
  1094.      */
  1095.     function display($resource_name, $cache_id = null, $compile_id = null)
  1096.     {
  1097.         $this->fetch($resource_name, $cache_id, $compile_id, true);
  1098.     }
  1099.  
  1100.     /**
  1101.      * executes & returns or displays the template results
  1102.      *
  1103.      * @param string $resource_name
  1104.      * @param string $cache_id
  1105.      * @param string $compile_id
  1106.      * @param boolean $display
  1107.      */
  1108.     function fetch($resource_name, $cache_id = null, $compile_id = null, $display = false)
  1109.     {
  1110.         static $_cache_info = array();
  1111.         
  1112.         $_smarty_old_error_level = $this->debugging ? error_reporting() : error_reporting(isset($this->error_reporting)
  1113.                ? $this->error_reporting : error_reporting() & ~E_NOTICE);
  1114.  
  1115.         if (!$this->debugging && $this->debugging_ctrl == 'URL') {
  1116.             $_query_string = $this->request_use_auto_globals ? $_SERVER['QUERY_STRING'] : $GLOBALS['HTTP_SERVER_VARS']['QUERY_STRING'];
  1117.             if (@strstr($_query_string, $this->_smarty_debug_id)) {
  1118.                 if (@strstr($_query_string, $this->_smarty_debug_id . '=on')) {
  1119.                     // enable debugging for this browser session
  1120.                     @setcookie('SMARTY_DEBUG', true);
  1121.                     $this->debugging = true;
  1122.                 } elseif (@strstr($_query_string, $this->_smarty_debug_id . '=off')) {
  1123.                     // disable debugging for this browser session
  1124.                     @setcookie('SMARTY_DEBUG', false);
  1125.                     $this->debugging = false;
  1126.                 } else {
  1127.                     // enable debugging for this page
  1128.                     $this->debugging = true;
  1129.                 }
  1130.             } else {
  1131.                 $_cookie_var = $this->request_use_auto_globals ? $_COOKIE['SMARTY_DEBUG'] : $GLOBALS['HTTP_COOKIE_VARS']['SMARTY_DEBUG'];
  1132.                 $this->debugging = $_cookie_var ? true : false;
  1133.             }
  1134.         }
  1135.  
  1136.         if ($this->debugging) {
  1137.             // capture time for debugging info
  1138.             $_params = array();
  1139.             require_once(SMARTY_DIR . 'core' . DIRECTORY_SEPARATOR . 'core.get_microtime.php');
  1140.             $_debug_start_time = smarty_core_get_microtime($_params, $this);
  1141.             $this->_smarty_debug_info[] = array('type'      => 'template',
  1142.                                                 'filename'  => $resource_name,
  1143.                                                 'depth'     => 0);
  1144.             $_included_tpls_idx = count($this->_smarty_debug_info) - 1;
  1145.         }
  1146.  
  1147.         if (!isset($compile_id)) {
  1148.             $compile_id = $this->compile_id;
  1149.         }
  1150.  
  1151.         $this->_compile_id = $compile_id;
  1152.         $this->_inclusion_depth = 0;
  1153.  
  1154.         if ($this->caching) {
  1155.             // save old cache_info, initialize cache_info
  1156.             array_push($_cache_info, $this->_cache_info);
  1157.             $this->_cache_info = array();
  1158.             $_params = array(
  1159.                 'tpl_file' => $resource_name,
  1160.                 'cache_id' => $cache_id,
  1161.                 'compile_id' => $compile_id,
  1162.                 'results' => null
  1163.             );
  1164.             require_once(SMARTY_DIR . 'core' . DIRECTORY_SEPARATOR . 'core.read_cache_file.php');
  1165.             if (smarty_core_read_cache_file($_params, $this)) {
  1166.                 $_smarty_results = $_params['results'];
  1167.                 if (@count($this->_cache_info['insert_tags'])) {
  1168.                     $_params = array('plugins' => $this->_cache_info['insert_tags']);
  1169.                     require_once(SMARTY_DIR . 'core' . DIRECTORY_SEPARATOR . 'core.load_plugins.php');
  1170.                     smarty_core_load_plugins($_params, $this);
  1171.                     $_params = array('results' => $_smarty_results);
  1172.                     require_once(SMARTY_DIR . 'core' . DIRECTORY_SEPARATOR . 'core.process_cached_inserts.php');
  1173.                     $_smarty_results = smarty_core_process_cached_inserts($_params, $this);
  1174.                 }
  1175.                 if (@count($this->_cache_info['cache_serials'])) {
  1176.                     $_params = array('results' => $_smarty_results);
  1177.                     require_once(SMARTY_DIR . 'core' . DIRECTORY_SEPARATOR . 'core.process_compiled_include.php');
  1178.                     $_smarty_results = smarty_core_process_compiled_include($_params, $this);
  1179.                 }
  1180.  
  1181.  
  1182.                 if ($display) {
  1183.                     if ($this->debugging)
  1184.                     {
  1185.                         // capture time for debugging info
  1186.                         $_params = array();
  1187.                         require_once(SMARTY_DIR . 'core' . DIRECTORY_SEPARATOR . 'core.get_microtime.php');
  1188.                         $this->_smarty_debug_info[$_included_tpls_idx]['exec_time'] = smarty_core_get_microtime($_params, $this) - $_debug_start_time;
  1189.                         require_once(SMARTY_DIR . 'core' . DIRECTORY_SEPARATOR . 'core.display_debug_console.php');
  1190.                         $_smarty_results .= smarty_core_display_debug_console($_params, $this);
  1191.                     }
  1192.                     if ($this->cache_modified_check) {
  1193.                         $_server_vars = ($this->request_use_auto_globals) ? $_SERVER : $GLOBALS['HTTP_SERVER_VARS'];
  1194.                         $_last_modified_date = @substr($_server_vars['HTTP_IF_MODIFIED_SINCE'], 0, strpos($_server_vars['HTTP_IF_MODIFIED_SINCE'], 'GMT') + 3);
  1195.                         $_gmt_mtime = gmdate('D, d M Y H:i:s', $this->_cache_info['timestamp']).' GMT';
  1196.                         if (@count($this->_cache_info['insert_tags']) == 0
  1197.                             && !$this->_cache_serials
  1198.                             && $_gmt_mtime == $_last_modified_date) {
  1199.                             if (php_sapi_name()=='cgi')
  1200.                                 header('Status: 304 Not Modified');
  1201.                             else
  1202.                                 header('HTTP/1.1 304 Not Modified');
  1203.  
  1204.                         } else {
  1205.                             header('Last-Modified: '.$_gmt_mtime);
  1206.                             echo $_smarty_results;
  1207.                         }
  1208.                     } else {
  1209.                             echo $_smarty_results;
  1210.                     }
  1211.                     error_reporting($_smarty_old_error_level);
  1212.                     // restore initial cache_info
  1213.                     $this->_cache_info = array_pop($_cache_info);
  1214.                     return true;
  1215.                 } else {
  1216.                     error_reporting($_smarty_old_error_level);
  1217.                     // restore initial cache_info
  1218.                     $this->_cache_info = array_pop($_cache_info);
  1219.                     return $_smarty_results;
  1220.                 }
  1221.             } else {
  1222.                 $this->_cache_info['template'][$resource_name] = true;
  1223.                 if ($this->cache_modified_check && $display) {
  1224.                     header('Last-Modified: '.gmdate('D, d M Y H:i:s', time()).' GMT');
  1225.                 }
  1226.             }
  1227.         }
  1228.  
  1229.         // load filters that are marked as autoload
  1230.         if (count($this->autoload_filters)) {
  1231.             foreach ($this->autoload_filters as $_filter_type => $_filters) {
  1232.                 foreach ($_filters as $_filter) {
  1233.                     $this->load_filter($_filter_type, $_filter);
  1234.                 }
  1235.             }
  1236.         }
  1237.  
  1238.         $_smarty_compile_path = $this->_get_compile_path($resource_name);
  1239.  
  1240.         // if we just need to display the results, don't perform output
  1241.         // buffering - for speed
  1242.         $_cache_including = $this->_cache_including;
  1243.         $this->_cache_including = false;
  1244.         if ($display && !$this->caching && count($this->_plugins['outputfilter']) == 0) {
  1245.             if ($this->_is_compiled($resource_name, $_smarty_compile_path)
  1246.                     || $this->_compile_resource($resource_name, $_smarty_compile_path))
  1247.             {
  1248.                 include($_smarty_compile_path);
  1249.             }
  1250.         } else {
  1251.             ob_start();
  1252.             if ($this->_is_compiled($resource_name, $_smarty_compile_path)
  1253.                     || $this->_compile_resource($resource_name, $_smarty_compile_path))
  1254.             {
  1255.                 include($_smarty_compile_path);
  1256.             }
  1257.             $_smarty_results = ob_get_contents();
  1258.             ob_end_clean();
  1259.  
  1260.             foreach ((array)$this->_plugins['outputfilter'] as $_output_filter) {
  1261.                 $_smarty_results = call_user_func_array($_output_filter[0], array($_smarty_results, &$this));
  1262.             }
  1263.         }
  1264.  
  1265.         if ($this->caching) {
  1266.             $_params = array('tpl_file' => $resource_name,
  1267.                         'cache_id' => $cache_id,
  1268.                         'compile_id' => $compile_id,
  1269.                         'results' => $_smarty_results);
  1270.             require_once(SMARTY_DIR . 'core' . DIRECTORY_SEPARATOR . 'core.write_cache_file.php');
  1271.             smarty_core_write_cache_file($_params, $this);
  1272.             require_once(SMARTY_DIR . 'core' . DIRECTORY_SEPARATOR . 'core.process_cached_inserts.php');
  1273.             $_smarty_results = smarty_core_process_cached_inserts($_params, $this);
  1274.  
  1275.             if ($this->_cache_serials) {
  1276.                 // strip nocache-tags from output
  1277.                 $_smarty_results = preg_replace('!(\{/?nocache\:[0-9a-f]{32}#\d+\})!s'
  1278.                                                 ,''
  1279.                                                 ,$_smarty_results);
  1280.             }
  1281.             // restore initial cache_info
  1282.             $this->_cache_info = array_pop($_cache_info);
  1283.         }
  1284.         $this->_cache_including = $_cache_including;
  1285.  
  1286.         if ($display) {
  1287.             if (isset($_smarty_results)) { echo $_smarty_results; }
  1288.             if ($this->debugging) {
  1289.                 // capture time for debugging info
  1290.                 $_params = array();
  1291.                 require_once(SMARTY_DIR . 'core' . DIRECTORY_SEPARATOR . 'core.get_microtime.php');
  1292.                 $this->_smarty_debug_info[$_included_tpls_idx]['exec_time'] = (smarty_core_get_microtime($_params, $this) - $_debug_start_time);
  1293.                 require_once(SMARTY_DIR . 'core' . DIRECTORY_SEPARATOR . 'core.display_debug_console.php');
  1294.                 echo smarty_core_display_debug_console($_params, $this);
  1295.             }
  1296.             error_reporting($_smarty_old_error_level);
  1297.             return;
  1298.         } else {
  1299.             error_reporting($_smarty_old_error_level);
  1300.             if (isset($_smarty_results)) { return $_smarty_results; }
  1301.         }
  1302.     }
  1303.  
  1304.     /**
  1305.      * load configuration values
  1306.      *
  1307.      * @param string $file
  1308.      * @param string $section
  1309.      * @param string $scope
  1310.      */
  1311.     function config_load($file, $section = null, $scope = 'global')
  1312.     {
  1313.         require_once($this->_get_plugin_filepath('function', 'config_load'));
  1314.         smarty_function_config_load(array('file' => $file, 'section' => $section, 'scope' => $scope), $this);
  1315.     }
  1316.  
  1317.     /**
  1318.      * return a reference to a registered object
  1319.      *
  1320.      * @param string $name
  1321.      * @return object
  1322.      */
  1323.     function &get_registered_object($name) {
  1324.         if (!isset($this->_reg_objects[$name]))
  1325.         $this->_trigger_fatal_error("'$name' is not a registered object");
  1326.  
  1327.         if (!is_object($this->_reg_objects[$name][0]))
  1328.         $this->_trigger_fatal_error("registered '$name' is not an object");
  1329.  
  1330.         return $this->_reg_objects[$name][0];
  1331.     }
  1332.  
  1333.     /**
  1334.      * clear configuration values
  1335.      *
  1336.      * @param string $var
  1337.      */
  1338.     function clear_config($var = null)
  1339.     {
  1340.         if(!isset($var)) {
  1341.             // clear all values
  1342.             $this->_config = array(array('vars'  => array(),
  1343.                                          'files' => array()));
  1344.         } else {
  1345.             unset($this->_config[0]['vars'][$var]);
  1346.         }
  1347.     }
  1348.  
  1349.     /**
  1350.      * get filepath of requested plugin
  1351.      *
  1352.      * @param string $type
  1353.      * @param string $name
  1354.      * @return string|false
  1355.      */
  1356.     function _get_plugin_filepath($type, $name)
  1357.     {
  1358.         $_params = array('type' => $type, 'name' => $name);
  1359.         require_once(SMARTY_DIR . 'core' . DIRECTORY_SEPARATOR . 'core.assemble_plugin_filepath.php');
  1360.         return smarty_core_assemble_plugin_filepath($_params, $this);
  1361.     }
  1362.  
  1363.    /**
  1364.      * test if resource needs compiling
  1365.      *
  1366.      * @param string $resource_name
  1367.      * @param string $compile_path
  1368.      * @return boolean
  1369.      */
  1370.     function _is_compiled($resource_name, $compile_path)
  1371.     {
  1372.         if (!$this->force_compile && file_exists($compile_path)) {
  1373.             if (!$this->compile_check) {
  1374.                 // no need to check compiled file
  1375.                 return true;
  1376.             } else {
  1377.                 // get file source and timestamp
  1378.                 $_params = array('resource_name' => $resource_name, 'get_source'=>false);
  1379.                 if (!$this->_fetch_resource_info($_params)) {
  1380.                     return false;
  1381.                 }
  1382.                 if ($_params['resource_timestamp'] <= filemtime($compile_path)) {
  1383.                     // template not expired, no recompile
  1384.                     return true;
  1385.                 } else {
  1386.                     // compile template
  1387.                     return false;
  1388.                 }
  1389.             }
  1390.         } else {
  1391.             // compiled template does not exist, or forced compile
  1392.             return false;
  1393.         }
  1394.     }
  1395.  
  1396.    /**
  1397.      * compile the template
  1398.      *
  1399.      * @param string $resource_name
  1400.      * @param string $compile_path
  1401.      * @return boolean
  1402.      */
  1403.     function _compile_resource($resource_name, $compile_path)
  1404.     {
  1405.  
  1406.         $_params = array('resource_name' => $resource_name);
  1407.         if (!$this->_fetch_resource_info($_params)) {
  1408.             return false;
  1409.         }
  1410.  
  1411.         $_source_content = $_params['source_content'];
  1412.         $_cache_include    = substr($compile_path, 0, -4).'.inc';
  1413.  
  1414.         if ($this->_compile_source($resource_name, $_source_content, $_compiled_content, $_cache_include)) {
  1415.             // if a _cache_serial was set, we also have to write an include-file:
  1416.             if ($this->_cache_include_info) {
  1417.                 require_once(SMARTY_DIR . 'core' . DIRECTORY_SEPARATOR . 'core.write_compiled_include.php');
  1418.                 smarty_core_write_compiled_include(array_merge($this->_cache_include_info, array('compiled_content'=>$_compiled_content)),  $this);
  1419.             }
  1420.  
  1421.             $_params = array('compile_path'=>$compile_path, 'compiled_content' => $_compiled_content);
  1422.             require_once(SMARTY_DIR . 'core' . DIRECTORY_SEPARATOR . 'core.write_compiled_resource.php');
  1423.             smarty_core_write_compiled_resource($_params, $this);
  1424.  
  1425.             return true;
  1426.         } else {
  1427.             return false;
  1428.         }
  1429.  
  1430.     }
  1431.  
  1432.    /**
  1433.      * compile the given source
  1434.      *
  1435.      * @param string $resource_name
  1436.      * @param string $source_content
  1437.      * @param string $compiled_content
  1438.      * @return boolean
  1439.      */
  1440.     function _compile_source($resource_name, &$source_content, &$compiled_content, $cache_include_path=null)
  1441.     {
  1442.         if (file_exists(SMARTY_DIR . $this->compiler_file)) {
  1443.             require_once(SMARTY_DIR . $this->compiler_file);
  1444.         } else {
  1445.             // use include_path
  1446.             require_once($this->compiler_file);
  1447.         }
  1448.  
  1449.  
  1450.         $smarty_compiler = new $this->compiler_class;
  1451.  
  1452.         $smarty_compiler->template_dir      = $this->template_dir;
  1453.         $smarty_compiler->compile_dir       = $this->compile_dir;
  1454.         $smarty_compiler->plugins_dir       = $this->plugins_dir;
  1455.         $smarty_compiler->config_dir        = $this->config_dir;
  1456.         $smarty_compiler->force_compile     = $this->force_compile;
  1457.         $smarty_compiler->caching           = $this->caching;
  1458.         $smarty_compiler->php_handling      = $this->php_handling;
  1459.         $smarty_compiler->left_delimiter    = $this->left_delimiter;
  1460.         $smarty_compiler->right_delimiter   = $this->right_delimiter;
  1461.         $smarty_compiler->_version          = $this->_version;
  1462.         $smarty_compiler->security          = $this->security;
  1463.         $smarty_compiler->secure_dir        = $this->secure_dir;
  1464.         $smarty_compiler->security_settings = $this->security_settings;
  1465.         $smarty_compiler->trusted_dir       = $this->trusted_dir;
  1466.         $smarty_compiler->use_sub_dirs      = $this->use_sub_dirs;
  1467.         $smarty_compiler->_reg_objects      = &$this->_reg_objects;
  1468.         $smarty_compiler->_plugins          = &$this->_plugins;
  1469.         $smarty_compiler->_tpl_vars         = &$this->_tpl_vars;
  1470.         $smarty_compiler->default_modifiers = $this->default_modifiers;
  1471.         $smarty_compiler->compile_id        = $this->_compile_id;
  1472.         $smarty_compiler->_config            = $this->_config;
  1473.         $smarty_compiler->request_use_auto_globals  = $this->request_use_auto_globals;
  1474.  
  1475.         $smarty_compiler->_cache_serial = null;
  1476.         $smarty_compiler->_cache_include = $cache_include_path;
  1477.  
  1478.  
  1479.         $_results = $smarty_compiler->_compile_file($resource_name, $source_content, $compiled_content);
  1480.  
  1481.         if ($smarty_compiler->_cache_serial) {
  1482.             $this->_cache_include_info = array(
  1483.                 'cache_serial'=>$smarty_compiler->_cache_serial
  1484.                 ,'plugins_code'=>$smarty_compiler->_plugins_code
  1485.                 ,'include_file_path' => $cache_include_path);
  1486.  
  1487.         } else {
  1488.             $this->_cache_include_info = null;
  1489.  
  1490.         }
  1491.  
  1492.         return $_results;
  1493.     }
  1494.  
  1495.     /**
  1496.      * Get the compile path for this resource
  1497.      *
  1498.      * @param string $resource_name
  1499.      * @return string results of {@link _get_auto_filename()}
  1500.      */
  1501.     function _get_compile_path($resource_name)
  1502.     {
  1503.         return $this->_get_auto_filename($this->compile_dir, $resource_name,
  1504.                                          $this->_compile_id) . '.php';
  1505.     }
  1506.  
  1507.     /**
  1508.      * fetch the template info. Gets timestamp, and source
  1509.      * if get_source is true
  1510.      *
  1511.      * sets $source_content to the source of the template, and
  1512.      * $resource_timestamp to its time stamp
  1513.      * @param string $resource_name
  1514.      * @param string $source_content
  1515.      * @param integer $resource_timestamp
  1516.      * @param boolean $get_source
  1517.      * @param boolean $quiet
  1518.      * @return boolean
  1519.      */
  1520.  
  1521.     function _fetch_resource_info(&$params)
  1522.     {
  1523.         if(!isset($params['get_source'])) { $params['get_source'] = true; }
  1524.         if(!isset($params['quiet'])) { $params['quiet'] = false; }
  1525.  
  1526.         $_return = false;
  1527.         $_params = array('resource_name' => $params['resource_name']) ;
  1528.         if (isset($params['resource_base_path']))
  1529.             $_params['resource_base_path'] = $params['resource_base_path'];
  1530.         else
  1531.             $_params['resource_base_path'] = $this->template_dir;
  1532.  
  1533.         if ($this->_parse_resource_name($_params)) {
  1534.             $_resource_type = $_params['resource_type'];
  1535.             $_resource_name = $_params['resource_name'];
  1536.             switch ($_resource_type) {
  1537.                 case 'file':
  1538.                     if ($params['get_source']) {
  1539.                         $params['source_content'] = $this->_read_file($_resource_name);
  1540.                     }
  1541.                     $params['resource_timestamp'] = filemtime($_resource_name);
  1542.                     $_return = is_file($_resource_name);
  1543.                     break;
  1544.  
  1545.                 default:
  1546.                     // call resource functions to fetch the template source and timestamp
  1547.                     if ($params['get_source']) {
  1548.                         $_source_return = isset($this->_plugins['resource'][$_resource_type]) &&
  1549.                             call_user_func_array($this->_plugins['resource'][$_resource_type][0][0],
  1550.                                                  array($_resource_name, &$params['source_content'], &$this));
  1551.                     } else {
  1552.                         $_source_return = true;
  1553.                     }
  1554.  
  1555.                     $_timestamp_return = isset($this->_plugins['resource'][$_resource_type]) &&
  1556.                         call_user_func_array($this->_plugins['resource'][$_resource_type][0][1],
  1557.                                              array($_resource_name, &$params['resource_timestamp'], &$this));
  1558.  
  1559.                     $_return = $_source_return && $_timestamp_return;
  1560.                     break;
  1561.             }
  1562.         }
  1563.  
  1564.         if (!$_return) {
  1565.             // see if we can get a template with the default template handler
  1566.             if (!empty($this->default_template_handler_func)) {
  1567.                 if (!is_callable($this->default_template_handler_func)) {
  1568.                     $this->trigger_error("default template handler function \"$this->default_template_handler_func\" doesn't exist.");
  1569.                 } else {
  1570.                     $_return = call_user_func_array(
  1571.                         $this->default_template_handler_func,
  1572.                         array($_params['resource_type'], $_params['resource_name'], &$params['source_content'], &$params['resource_timestamp'], &$this));
  1573.                 }
  1574.             }
  1575.         }
  1576.  
  1577.         if (!$_return) {
  1578.             if (!$params['quiet']) {
  1579.                 $this->trigger_error('unable to read resource: "' . $params['resource_name'] . '"');
  1580.             }
  1581.         } else if ($_return && $this->security) {
  1582.             require_once(SMARTY_DIR . 'core' . DIRECTORY_SEPARATOR . 'core.is_secure.php');
  1583.             if (!smarty_core_is_secure($_params, $this)) {
  1584.                 if (!$params['quiet'])
  1585.                     $this->trigger_error('(secure mode) accessing "' . $params['resource_name'] . '" is not allowed');
  1586.                 $params['source_content'] = null;
  1587.                 $params['resource_timestamp'] = null;
  1588.                 return false;
  1589.             }
  1590.         }
  1591.         return $_return;
  1592.     }
  1593.  
  1594.  
  1595.     /**
  1596.      * parse out the type and name from the resource
  1597.      *
  1598.      * @param string $resource_base_path
  1599.      * @param string $resource_name
  1600.      * @param string $resource_type
  1601.      * @param string $resource_name
  1602.      * @return boolean
  1603.      */
  1604.  
  1605.     function _parse_resource_name(&$params)
  1606.     {
  1607.  
  1608.         // split tpl_path by the first colon
  1609.         $_resource_name_parts = explode(':', $params['resource_name'], 2);
  1610.  
  1611.         if (count($_resource_name_parts) == 1) {
  1612.             // no resource type given
  1613.             $params['resource_type'] = $this->default_resource_type;
  1614.             $params['resource_name'] = $_resource_name_parts[0];
  1615.         } else {
  1616.             if(strlen($_resource_name_parts[0]) == 1) {
  1617.                 // 1 char is not resource type, but part of filepath
  1618.                 $params['resource_type'] = $this->default_resource_type;
  1619.                 $params['resource_name'] = $params['resource_name'];
  1620.             } else {
  1621.                 $params['resource_type'] = $_resource_name_parts[0];
  1622.                 $params['resource_name'] = $_resource_name_parts[1];
  1623.             }
  1624.         }
  1625.  
  1626.         if ($params['resource_type'] == 'file') {
  1627.             if (!preg_match('/^([\/\\\\]|[a-zA-Z]:[\/\\\\])/', $params['resource_name'])) {
  1628.                 // relative pathname to $params['resource_base_path']
  1629.                 // use the first directory where the file is found
  1630.                 foreach ((array)$params['resource_base_path'] as $_curr_path) {
  1631.                     $_fullpath = $_curr_path . DIRECTORY_SEPARATOR . $params['resource_name'];
  1632.                     if (file_exists($_fullpath) && is_file($_fullpath)) {
  1633.                         $params['resource_name'] = $_fullpath;
  1634.                         return true;
  1635.                     }
  1636.                     // didn't find the file, try include_path
  1637.                     $_params = array('file_path' => $_fullpath);
  1638.                     require_once(SMARTY_DIR . 'core' . DIRECTORY_SEPARATOR . 'core.get_include_path.php');
  1639.                     if(smarty_core_get_include_path($_params, $this)) {
  1640.                         $params['resource_name'] = $_params['new_file_path'];
  1641.                         return true;
  1642.                     }
  1643.                 }
  1644.                 return false;
  1645.             } else {
  1646.                 /* absolute path */
  1647.                 return file_exists($params['resource_name']);
  1648.             }
  1649.         } elseif (empty($this->_plugins['resource'][$params['resource_type']])) {
  1650.             $_params = array('type' => $params['resource_type']);
  1651.             require_once(SMARTY_DIR . 'core' . DIRECTORY_SEPARATOR . 'core.load_resource_plugin.php');
  1652.             smarty_core_load_resource_plugin($_params, $this);
  1653.         }
  1654.  
  1655.         return true;
  1656.     }
  1657.  
  1658.  
  1659.     /**
  1660.      * Handle modifiers
  1661.      *
  1662.      * @param string|null $modifier_name
  1663.      * @param array|null $map_array
  1664.      * @return string result of modifiers
  1665.      */
  1666.     function _run_mod_handler()
  1667.     {
  1668.         $_args = func_get_args();
  1669.         list($_modifier_name, $_map_array) = array_splice($_args, 0, 2);
  1670.         list($_func_name, $_tpl_file, $_tpl_line) =
  1671.             $this->_plugins['modifier'][$_modifier_name];
  1672.  
  1673.         $_var = $_args[0];
  1674.         foreach ($_var as $_key => $_val) {
  1675.             $_args[0] = $_val;
  1676.             $_var[$_key] = call_user_func_array($_func_name, $_args);
  1677.         }
  1678.         return $_var;
  1679.     }
  1680.  
  1681.     /**
  1682.      * Remove starting and ending quotes from the string
  1683.      *
  1684.      * @param string $string
  1685.      * @return string
  1686.      */
  1687.     function _dequote($string)
  1688.     {
  1689.         if (($string{0} == "'" || $string{0} == '"') &&
  1690.             $string{strlen($string)-1} == $string{0})
  1691.             return substr($string, 1, -1);
  1692.         else
  1693.             return $string;
  1694.     }
  1695.  
  1696.  
  1697.     /**
  1698.      * read in a file from line $start for $lines.
  1699.      * read the entire file if $start and $lines are null.
  1700.      *
  1701.      * @param string $filename
  1702.      * @param integer $start
  1703.      * @param integer $lines
  1704.      * @return string
  1705.      */
  1706.     function _read_file($filename)
  1707.     {
  1708.         if ( file_exists($filename) && ($fd = @fopen($filename, 'rb')) ) {
  1709.             $contents = ($size = filesize($filename)) ? fread($fd, $size) : '';
  1710.             fclose($fd);
  1711.             return $contents;
  1712.         } else {
  1713.             return false;
  1714.         }
  1715.     }
  1716.  
  1717.     /**
  1718.      * get a concrete filename for automagically created content
  1719.      *
  1720.      * @param string $auto_base
  1721.      * @param string $auto_source
  1722.      * @param string $auto_id
  1723.      * @return string
  1724.      * @staticvar string|null
  1725.      * @staticvar string|null
  1726.      */
  1727.     function _get_auto_filename($auto_base, $auto_source = null, $auto_id = null)
  1728.     {
  1729.         $_compile_dir_sep =  $this->use_sub_dirs ? DIRECTORY_SEPARATOR : '^';
  1730.         $_return = $auto_base . DIRECTORY_SEPARATOR;
  1731.  
  1732.         if(isset($auto_id)) {
  1733.             // make auto_id safe for directory names
  1734.             $auto_id = str_replace('%7C',$_compile_dir_sep,(urlencode($auto_id)));
  1735.             // split into separate directories
  1736.             $_return .= $auto_id . $_compile_dir_sep;
  1737.         }
  1738.  
  1739.         if(isset($auto_source)) {
  1740.             // make source name safe for filename
  1741.             $_filename = urlencode(basename($auto_source));
  1742.             $_crc32 = sprintf('%08X', crc32($auto_source));
  1743.             // prepend %% to avoid name conflicts with
  1744.             // with $params['auto_id'] names
  1745.             $_crc32 = substr($_crc32, 0, 2) . $_compile_dir_sep .
  1746.                       substr($_crc32, 0, 3) . $_compile_dir_sep . $_crc32;
  1747.             $_return .= '%%' . $_crc32 . '%%' . $_filename;
  1748.         }
  1749.  
  1750.         return $_return;
  1751.     }
  1752.  
  1753.     /**
  1754.      * unlink a file, possibly using expiration time
  1755.      *
  1756.      * @param string $resource
  1757.      * @param integer $exp_time
  1758.      */
  1759.     function _unlink($resource, $exp_time = null)
  1760.     {
  1761.         if(isset($exp_time)) {
  1762.             if(time() - @filemtime($resource) >= $exp_time) {
  1763.                 return @unlink($resource);
  1764.             }
  1765.         } else {
  1766.             return @unlink($resource);
  1767.         }
  1768.     }
  1769.  
  1770.     /**
  1771.      * returns an auto_id for auto-file-functions
  1772.      *
  1773.      * @param string $cache_id
  1774.      * @param string $compile_id
  1775.      * @return string|null
  1776.      */
  1777.     function _get_auto_id($cache_id=null, $compile_id=null) {
  1778.     if (isset($cache_id))
  1779.         return (isset($compile_id)) ? $cache_id . '|' . $compile_id  : $cache_id;
  1780.     elseif(isset($compile_id))
  1781.         return $compile_id;
  1782.     else
  1783.         return null;
  1784.     }
  1785.  
  1786.     /**
  1787.      * trigger Smarty plugin error
  1788.      *
  1789.      * @param string $error_msg
  1790.      * @param string $tpl_file
  1791.      * @param integer $tpl_line
  1792.      * @param string $file
  1793.      * @param integer $line
  1794.      * @param integer $error_type
  1795.      */
  1796.     function _trigger_fatal_error($error_msg, $tpl_file = null, $tpl_line = null,
  1797.             $file = null, $line = null, $error_type = E_USER_ERROR)
  1798.     {
  1799.         if(isset($file) && isset($line)) {
  1800.             $info = ' ('.basename($file).", line $line)";
  1801.         } else {
  1802.             $info = '';
  1803.         }
  1804.         if (isset($tpl_line) && isset($tpl_file)) {
  1805.             $this->trigger_error('[in ' . $tpl_file . ' line ' . $tpl_line . "]: $error_msg$info", $error_type);
  1806.         } else {
  1807.             $this->trigger_error($error_msg . $info, $error_type);
  1808.         }
  1809.     }
  1810.  
  1811.  
  1812.     /**
  1813.      * callback function for preg_replace, to call a non-cacheable block
  1814.      * @return string
  1815.      */
  1816.     function _process_compiled_include_callback($match) {
  1817.         $_func = '_smarty_tplfunc_'.$match[2].'_'.$match[3];
  1818.         ob_start();
  1819.         $_func($this);
  1820.         $_ret = ob_get_contents();
  1821.         ob_end_clean();
  1822.         return $_ret;
  1823.     }
  1824.  
  1825.  
  1826.     /**
  1827.      * called for included templates
  1828.      *
  1829.      * @param string $_smarty_include_tpl_file
  1830.      * @param string $_smarty_include_vars
  1831.      */
  1832.  
  1833.     // $_smarty_include_tpl_file, $_smarty_include_vars
  1834.  
  1835.     function _smarty_include($params)
  1836.     {
  1837.         if ($this->debugging) {
  1838.             $_params = array();
  1839.             require_once(SMARTY_DIR . 'core' . DIRECTORY_SEPARATOR . 'core.get_microtime.php');
  1840.             $debug_start_time = smarty_core_get_microtime($_params, $this);
  1841.             $this->_smarty_debug_info[] = array('type'      => 'template',
  1842.                                                   'filename'  => $params['smarty_include_tpl_file'],
  1843.                                                   'depth'     => ++$this->_inclusion_depth);
  1844.             $included_tpls_idx = count($this->_smarty_debug_info) - 1;
  1845.         }
  1846.  
  1847.         $this->_tpl_vars = array_merge($this->_tpl_vars, $params['smarty_include_vars']);
  1848.  
  1849.         // config vars are treated as local, so push a copy of the
  1850.         // current ones onto the front of the stack
  1851.         array_unshift($this->_config, $this->_config[0]);
  1852.  
  1853.         $_smarty_compile_path = $this->_get_compile_path($params['smarty_include_tpl_file']);
  1854.  
  1855.  
  1856.         if ($this->_is_compiled($params['smarty_include_tpl_file'], $_smarty_compile_path)
  1857.             || $this->_compile_resource($params['smarty_include_tpl_file'], $_smarty_compile_path))
  1858.         {
  1859.             include($_smarty_compile_path);
  1860.         }
  1861.  
  1862.         // pop the local vars off the front of the stack
  1863.         array_shift($this->_config);
  1864.  
  1865.         $this->_inclusion_depth--;
  1866.  
  1867.         if ($this->debugging) {
  1868.             // capture time for debugging info
  1869.             $_params = array();
  1870.             require_once(SMARTY_DIR . 'core' . DIRECTORY_SEPARATOR . 'core.get_microtime.php');
  1871.             $this->_smarty_debug_info[$included_tpls_idx]['exec_time'] = smarty_core_get_microtime($_params, $this) - $debug_start_time;
  1872.         }
  1873.  
  1874.         if ($this->caching) {
  1875.             $this->_cache_info['template'][$params['smarty_include_tpl_file']] = true;
  1876.         }
  1877.     }
  1878.  
  1879.  
  1880.     /**
  1881.      * get or set an array of cached attributes for function that is
  1882.      * not cacheable
  1883.      * @return array
  1884.      */
  1885.     function &_smarty_cache_attrs($cache_serial, $count) {
  1886.         $_cache_attrs =& $this->_cache_info['cache_attrs'][$cache_serial][$count];
  1887.  
  1888.         if ($this->_cache_including) {
  1889.             /* return next set of cache_attrs */
  1890.             $_return =& current($_cache_attrs);
  1891.             next($_cache_attrs);
  1892.             return $_return;
  1893.  
  1894.         } else {
  1895.             /* add a reference to a new set of cache_attrs */
  1896.             $_cache_attrs[] = array();
  1897.             return $_cache_attrs[count($_cache_attrs)-1];
  1898.  
  1899.         }
  1900.  
  1901.     }
  1902.  
  1903.  
  1904.     /**
  1905.      * wrapper for include() retaining $this
  1906.      * @return mixed
  1907.      */
  1908.     function _include($filename, $once=false, $params=null)
  1909.     {
  1910.         if ($once) {
  1911.             return include_once($filename);
  1912.         } else {
  1913.             return include($filename);
  1914.         }
  1915.     }
  1916.  
  1917.  
  1918.     /**
  1919.      * wrapper for eval() retaining $this
  1920.      * @return mixed
  1921.      */
  1922.     function _eval($code, $params=null)
  1923.     {
  1924.         return eval($code);
  1925.     }
  1926.     /**#@-*/
  1927.  
  1928. }
  1929.  
  1930. /* vim: set expandtab: */
  1931.  
  1932. ?>
  1933.